package com.smart.community.work.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.smart.community.work.dto.LeaveQueryDTO;
import com.smart.community.work.entity.Leave;
import com.smart.community.work.vo.LeaveVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDate;
import java.util.List;
import java.util.Map;

/**
 * 请假记录Mapper接口
 * 
 * 严格按照《Java后端SpringBoot代码开发规范_重构版.md》Mapper规范实现：
 * - 继承BaseMapper：获得基础CRUD方法
 * - 方法命名：使用动词+名词形式，语义明确
 * - 参数注解：使用@Param注解标注参数
 * - 返回类型：使用具体的返回类型，避免使用Object
 * - 完整注释：所有方法都有完整的JavaDoc注释
 * - 数据访问封装：Mapper层负责所有数据库操作
 * - SQL优化：编写高效的SQL语句
 * - 参数映射：正确使用MyBatis参数映射
 * - 结果映射：正确使用MyBatis结果映射
 * - 数据访问封装：Mapper层负责所有数据库操作
 * - SQL优化：编写高效的SQL语句
 * - 参数映射：正确使用MyBatis参数映射
 * - 结果映射：正确使用MyBatis结果映射
 *
 * @author Wu.Liang
 * @since 2025-01-30
 * @version 1.0.0
 */
@Mapper
public interface LeaveMapper extends BaseMapper<Leave> {

    /**
     * 分页查询请假记录
     *
     * @param page 分页参数
     * @param params 查询参数
     * @return 请假记录分页数据
     */
    IPage<LeaveVO> selectLeavePage(Page<LeaveVO> page, @Param("params") Map<String, Object> params);

    /**
     * 根据用户ID查询请假记录
     *
     * @param userId 用户ID
     * @param propertyCompanyId 物业公司ID
     * @return 请假记录列表
     */
    List<LeaveVO> selectByUserId(@Param("userId") Long userId, @Param("propertyCompanyId") Long propertyCompanyId);

    /**
     * 根据审批人ID查询待审批请假记录
     *
     * @param approverId 审批人ID
     * @param propertyCompanyId 物业公司ID
     * @return 待审批请假记录列表
     */
    List<LeaveVO> selectPendingByApproverId(@Param("approverId") Long approverId, @Param("propertyCompanyId") Long propertyCompanyId);

    /**
     * 查询用户指定时间段的请假记录
     *
     * @param userId 用户ID
     * @param propertyCompanyId 物业公司ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 请假记录列表
     */
    List<LeaveVO> selectByUserIdAndDateRange(@Param("userId") Long userId, 
                                           @Param("propertyCompanyId") Long propertyCompanyId,
                                           @Param("startDate") LocalDate startDate, 
                                           @Param("endDate") LocalDate endDate);

    /**
     * 统计用户请假时长
     *
     * @param userId 用户ID
     * @param propertyCompanyId 物业公司ID
     * @param year 年份
     * @param leaveType 请假类型
     * @return 请假总时长
     */
    Double selectTotalLeaveHours(@Param("userId") Long userId, 
                               @Param("propertyCompanyId") Long propertyCompanyId,
                               @Param("year") Integer year, 
                               @Param("leaveType") Integer leaveType);

    /**
     * 查询请假统计信息
     *
     * @param propertyCompanyId 物业公司ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 统计信息
     */
    Map<String, Object> selectLeaveStatistics(@Param("propertyCompanyId") Long propertyCompanyId,
                                            @Param("startDate") LocalDate startDate,
                                            @Param("endDate") LocalDate endDate);

    /**
     * 检查请假时间冲突
     *
     * @param userId 用户ID
     * @param propertyCompanyId 物业公司ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @param excludeId 排除的记录ID
     * @return 冲突记录数量
     */
    Integer checkTimeConflict(@Param("userId") Long userId,
                            @Param("propertyCompanyId") Long propertyCompanyId,
                            @Param("startTime") String startTime,
                            @Param("endTime") String endTime,
                            @Param("excludeId") Long excludeId);

    /**
     * 根据ID查询请假记录详情
     *
     * @param id 请假记录ID
     * @return 请假记录详情
     */
    LeaveVO selectById(@Param("id") Long id);

    /**
     * 根据请假类型统计
     *
     * @param propertyCompanyId 物业公司ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 请假类型统计
     */
    List<Map<String, Object>> selectLeaveTypeStatistics(@Param("propertyCompanyId") Long propertyCompanyId,
                                                       @Param("startDate") LocalDate startDate,
                                                       @Param("endDate") LocalDate endDate);

    /**
     * 查询即将到期的请假记录
     *
     * @param propertyCompanyId 物业公司ID
     * @param days 提前天数
     * @return 即将到期的请假记录
     */
    List<LeaveVO> selectExpiringLeaves(@Param("propertyCompanyId") Long propertyCompanyId,
                                      @Param("days") Integer days);

    /**
     * 更新请假状态
     *
     * @param id 请假记录ID
     * @param status 状态
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer updateStatus(@Param("id") Long id, @Param("status") Integer status, @Param("updateBy") Long updateBy);

    /**
     * 审批请假
     *
     * @param id 请假记录ID
     * @param status 状态
     * @param approverId 审批人ID
     * @param approveTime 审批时间
     * @param approveRemark 审批备注
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer approveLeave(@Param("id") Long id,
                        @Param("status") Integer status,
                        @Param("approverId") Long approverId,
                        @Param("approveTime") java.time.LocalDateTime approveTime,
                        @Param("approveRemark") String approveRemark,
                        @Param("updateBy") Long updateBy);

    /**
     * 批量更新请假状态
     *
     * @param ids 请假记录ID列表
     * @param status 状态
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer batchUpdateStatus(@Param("ids") List<Long> ids, @Param("status") Integer status, @Param("updateBy") Long updateBy);

    /**
     * 删除请假记录
     *
     * @param id 请假记录ID
     * @param updateBy 更新人ID
     * @return 删除数量
     */
    Integer deleteById(@Param("id") Long id, @Param("updateBy") Long updateBy);

    /**
     * 批量删除请假记录
     *
     * @param ids 请假记录ID列表
     * @param updateBy 更新人ID
     * @return 删除数量
     */
    Integer batchDelete(@Param("ids") List<Long> ids, @Param("updateBy") Long updateBy);

    /**
     * 统计各状态请假数量
     * 
     * @param propertyCompanyId 物业公司ID
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 状态统计信息
     */
    List<Map<String, Object>> selectLeaveStatusStatistics(@Param("propertyCompanyId") Long propertyCompanyId,
                                                         @Param("startDate") LocalDate startDate,
                                                         @Param("endDate") LocalDate endDate);

    /**
     * 分页查询请假记录（支持数据权限控制）
     * 
     * @param page 分页参数
     * @param queryDTO 查询参数
     * @param allowedUserIds 允许查看的用户ID列表
     * @return 请假记录分页数据
     */
    IPage<LeaveVO> selectLeavePageWithUserIds(Page<LeaveVO> page, 
                                            @Param("queryDTO") LeaveQueryDTO queryDTO, 
                                            @Param("allowedUserIds") List<Long> allowedUserIds);

    /**
     * 分页查询请假记录（支持数据权限控制，支持多物业公司查询）
     * 
     * @param page 分页参数
     * @param queryDTO 查询参数
     * @param allowedUserIds 允许查看的用户ID列表
     * @param propertyCompanyIds 物业公司ID列表
     * @return 请假记录分页数据
     */
    IPage<LeaveVO> selectLeavePageWithUserIdsAndPropertyCompanies(Page<LeaveVO> page, 
                                                                @Param("queryDTO") LeaveQueryDTO queryDTO, 
                                                                @Param("allowedUserIds") List<Long> allowedUserIds,
                                                                @Param("propertyCompanyIds") List<Long> propertyCompanyIds);

    /**
     * 根据角色和物业公司查询用户ID列表
     * 
     * @param roleId 角色ID
     * @param propertyCompanyIds 物业公司ID列表
     * @return 用户ID列表
     */
    List<Long> getUserIdsByRoleAndPropertyCompany(@Param("roleId") Long roleId, 
                                                @Param("propertyCompanyIds") List<Long> propertyCompanyIds);

    /**
     * 根据物业公司查询所有用户ID列表
     * 
     * @param propertyCompanyIds 物业公司ID列表
     * @return 用户ID列表
     */
    List<Long> getAllUserIdsByPropertyCompany(@Param("propertyCompanyIds") List<Long> propertyCompanyIds);

    /**
     * 根据用户ID查询角色ID列表
     * 
     * @param userId 用户ID
     * @return 角色ID列表
     */
    List<Long> getUserRoleIds(@Param("userId") Long userId);
}
